<!DOCTYPE html>
<html lang="en">

<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>视频搜索接口文档</title>
  <style>
    body {
      font-family: Arial, sans-serif;
      margin: 20px;
      background-color: #f9f9f9;
    }

    .container {
      max-width: 800px;
      margin: 0 auto;
      background-color: #fff;
      padding: 20px;
      border-radius: 8px;
      box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
    }

    h1 {
      text-align: center;
      color: #333;
    }

    h2 {
      color: #555;
      border-bottom: 1px solid #ddd;
      padding-bottom: 10px;
      margin-top: 20px;
    }

    p {
      color: #666;
      line-height: 1.6;
    }

    table {
      width: 100%;
      border-collapse: collapse;
      margin-bottom: 20px;
    }

    th,
    td {
      padding: 10px;
      text-align: left;
      border: 1px solid #ddd;
    }

    th {
      background-color: #f5f5f5;
    }

    pre {
      background-color: #f5f5f5;
      padding: 10px;
      border-radius: 4px;
      overflow-x: auto;
    }

    code {
      font-family: 'Courier New', Courier, monospace;
      color: #333;
    }

    .note {
      background-color: #fff3cd;
      padding: 10px;
      border-left: 4px solid #ffc107;
      margin-bottom: 20px;
    }
  </style>
</head>

<body>
  <div class="container">
    <h1>视频搜索接口文档</h1>

    <h2>概述</h2>
    <p>本接口文档旨在详细描述视频搜索服务的API接口，包括请求方法、URL、请求参数、响应数据格式以及错误处理等内容。该服务允许用户通过关键字搜索视频资源，并返回相应的视频链接和信息。</p>

    <h2>基础URL</h2>
    <p><code>https://api.example.com/video</code></p>

    <h2>请求方法</h2>
    <p><code>POST</code></p>

    <h2>请求参数</h2>
    <p>请求参数通过<code>POST</code>请求的<code>body</code>传递，使用<code>application/x-www-form-urlencoded</code>格式。</p>
    <table>
      <tr>
        <th>参数名</th>
        <th>类型</th>
        <th>是否必填</th>
        <th>描述</th>
      </tr>
      <tr>
        <td>type</td>
        <td>string</td>
        <td>是</td>
        <td>搜索关键字</td>
      </tr>
    </table>

    <h2>响应数据</h2>
    <p>响应数据为<code>JSON</code>格式，具体字段如下：</p>

    <h3>成功响应</h3>
    <pre><code>[
  {
    "href": "视频链接",
    "img": "视频封面图片链接",
    "title": "视频标题"
  },
  {
    "href": "视频链接",
    "img": "视频封面图片链接",
    "title": "视频标题"
  }
]</code></pre>

    <h3>失败响应</h3>
    <pre><code>{
  "error": "错误信息"
}</code></pre>

    <h2>错误码及描述</h2>
    <table>
      <tr>
        <th>错误码</th>
        <th>描述</th>
      </tr>
      <tr>
        <td>400</td>
        <td>请求参数错误</td>
      </tr>
      <tr>
        <td>404</td>
        <td>未找到相关视频资源</td>
      </tr>
      <tr>
        <td>500</td>
        <td>服务器内部错误</td>
      </tr>
    </table>

    <h2>示例</h2>
    <h3>请求示例</h3>
    <pre><code>POST /video HTTP/1.1
Host: api.example.com
Content-Type: application/x-www-form-urlencoded

type=电影</code></pre>

    <h3>响应示例</h3>
    <pre><code>[
  {
    "href": "https://www.example.com/video1",
    "img": "https://www.example.com/image1.jpg",
    "title": "电影1"
  },
  {
    "href": "https://www.example.com/video2",
    "img": "https://www.example.com/image2.jpg",
    "title": "电影2"
  }
]</code></pre>

    <h3>错误示例</h3>
    <pre><code>{
  "error": "未找到相关视频资源"
}</code></pre>

    <h2>注意事项</h2>
    <div class="note">
      <p>1. 请求参数<code>type</code>不能为空。</p>
      <p>2. 响应数据中的<code>href</code>和<code>img</code>字段均为有效的URL链接。</p>
      <p>3. 如果搜索结果为空，响应数据将返回一个空数组。</p>
    </div>
  </div>
</body>

</html>